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Authoring Tools Framework 


• Create PC-based game development tools 

• C#, .NET 4.0 

• You choose the components you want, customize 
them, or add your own new ones 

• Used by most Sony Computer Entertainment 
l st -party studios 

• Open source on GitHub! 
http://github.com/SonyWWS 



p 


Authoring Tools Framework 





Adopters 

(Partial List) 


■ Naughty Dog -The Last of Us 

■ Charter Level editor 

■ Surfer Shader Editor 

■ Guerrilla Games - Killzone: Shadow Fall 

■ CoreText Editor - object and cinematic sequence editor 

■ Quantic Dream - Beyond: Two Souls 

■ Four StateMachine-based tools 

■ Santa Monica Studios - God of War 

■ Metrics - performance analyzer 

■ CreatureEditor - animation blending tool 

Bend Game Studio - Uncharted: Golden Abyss on PS Vita 

■ Level editor, etc. 

■ Zindagi 

■ State Machine, SLED, LiveEdit 



Adopters 

(Partial list) 


■ Cambridge Studio 

■ LittleBigPlanet PSP's Level Editor and Moderation Viewer 

■ Home 

■ Home Scene Editor 

■ ATG 

■ Sulpha - sound visualization and editing 

■ Nexus - Animation blending tool 

■ TNT 

■ SLED - LUA IDE & debugger 

■ StateMachine editor 

■ SCREAM Tool - audio effects authoring tool 

■ Liverpool Studios 

■ LevelEditor, StateMachine, SLED 

■ Zipper Interactive 

■ Atlas - Level editor using ATF 3 and SlimDX 


Naughty Dog's Charter Level Editor 
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"There was ATF code running behind every shader tweak and enemy placement in 
The Last of Us." - Dave Smith, Naughty Dog tools programmer 


Naughty Dog's Surfer Shader Editor 
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Guerrilla's CoreText Editor 
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Sequence and object editor for the Killzone series, including the 
Killzone: Shadow Fall PS4 launch title 
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Santa Monica Studios' Creature Editor 





LevelEditor (by Game Tech Group) 
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Metrics Viewer (by Game Tech Group) 
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LittleBigPlanet (PSP®) Level Editor 
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SLED 


(by Game Tech Group) 



State Machine 


(by Game Tech Group) 
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function Initialize () 
print {) 

print ("Soldier sample:") 

print (" Press the X button (ps3) or the space bar (w: 
print ( ) 

public. m_health = props.StartingHealth 


function OnEnterMachine ( ) 

print ("Hello, my name is " . . shared. props . SoldierNamt 

end 

function public. TaJceDamage () 

public. m_health = public. m_health - 1 

end 


function public . IsDead ( ) 

return public .m_health <= 0 

end 
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Main Components 

• DOM (Document Object Model) 

• XML and Schema files can be used, but are optional 

• Control Host Service with docking 

• WPF and WinForms 

• Editor Infrastructure 

• Commands 

• Documents 

• Transactions 

• History 

• Contexts 

• Search & Replace 

• Circuit, StateChart, Timeline with Direct2D 

• Script editing with syntax highlighting 

• Tree Control, Property Grid Editor, etc. 

• Maya-like 3D Design View (OpenGL) 

• ATGI and Collada model support 


We do the boring stuff 


File 

Edit View 

Modify Windo 
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New Document 

Ctrl+N 
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Open Document 

Ctrl+O 
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Save 

Ctrl+S 


Save As ... 
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Save All Ctrl + Shift +S 


Close Ctrl+W ; Ctrl+F4 
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Page Setup... 



Print Preview... 



Print... 

Ctrl + P 


Recent Files 
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Exit 
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Window 


Undo Drag and Drop 

Ctrl+Z 
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Redo 

Ctrl+Y 
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Cut 

Ctrl+X 
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Copy 

Ctrl+C 
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Paste 

Ctrl+V 
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Delete 

Delete 


Keyboard Shortcuts ., 

1 1 


Load or Save Settings... 
Preferences... 


\v 


You pick the parts you want 


\f f Create a type catalog with the types of components we want in the 
TypeCatalog catalog = new TypeCatalog( 


typeof (SettingsService), 

typeof (StatusService), 

typeof (CoimiandService), 

typeof (Cent ^clHcst Service), 

ty peof (At f U s a ge Lo gge r ) , 

typeof (Crash Logger) , 

typeof (UnhandledExceptionService) , 

typeof (FileDialogService), 


// persistent settings an- 
// status bar at bottom o - 
// menus and toolbars 
// docking control host 
// logs computer info to 
// logs unhandled excepti- 
// catches unhandled exce 
// standard Windows file 


typeof ( Cccuient Registry), 
typeof (Auto Do c umie n t S e r vi c e ) , 
ty p e o f ( Re c e nt Do c urn e nt C orrrr a n d s ) , 
typeof (St andardFileCommands) j 
typeof (■■'ain.’.'indowTitleService), 
typeof (TabbedControlSelect or), 
typeof (HelpAboutCoimniand)., 


// central document regis' 
// opens documents from 1 
// standard recent docume 
// standard File menu comi 
// tracks document change 
// enable ctrl-tab select 
// Help -> About command 


Open Sound Control 


■ Collaboration with Guerrilla Games 

■ Open standard, high-level network protocol 

■ Successor to MIDI 

■ Sends and receives name / value pairs 

■ Lemur ($50) for iPad works great 

■ TouchOSC for Android tablets works well, too 

■ Non-programmer can create GUI and tools 


Open Sound Control 


Q TouchOSC Editor - STEF2013_TouchOSC_layout.touchosc 
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Lemur for iOS 
+ scripting 
+ more controls 
+ editing on iPad 






Open Sound Control at Guerrilla Games 


DOM (Document Object Model) 


■ In-memory observable XML-like database 

■ DomNode trees 

■ Root of a DomNode tree is typically a document 

■ DomNodes have attributes and children 

■ Specified by a DomNodeType (like a schema type) 

■ Attributes, like in XML, are simple types (int, float, string, 
reference) or arrays of simple types. 

■ DomNodes are observable 

■ Child Added event 

■ Child Removed event 

■ Attribute Changed event 



DomNode Hierarchy 

- Each DomNode has certain attributes and children, 
specified by the DomNode's DomNodeType 

- DomNodeTypes can be created programmatically or by loading schema file 

- Events propagate from children to parents 
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Circuit Document 

Root events 
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Group 
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Adaptability 


■ lAdaptable 

■ Implemented by DomNode and DomNodeAdapter 

/// <summary> 

/// Interface for types that can provide adapters to other types</suminary> 
public interface lAdaptable 

{ 

object GetAdapter(Type type); 

} 

■ As<T> extension method on object 

■ First does C# 'as', then checks for lAdaptable 

/// <summary> 

/// Converts a reference to the given type by first trying a CILR cast^ and then 
/// trying to get an adapt er</summary> 

/// <typeparam name=’ , T 1 '>Desired type^ must be ref type</typeparam> 

/// <param name=”ref erence’'>Ref erence to convert</parain> 

/// <returns>Converted reference for the given object or null</returns> 
public static T As<T>(this object reference) 
where T : class 


DomNodeAdapters 


Clients' "business classes" derive from DomNodeAdapter and are defined 
for particular DomNodeTypes. A DomNode is created first and then its 
DomNodeAdapters are created automatically but are initialized on 
demand. Call InitializeExtensions on root DomNode to initialize all 
DomNodeAdapters for the whole tree. 


CircuitDocument 



HistoryContext 


Root DomNode 


class 

CircuitGroup 


class 

CircuitElement 
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Group 

DomNode 
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Group 

DomNode 



Circuit 

Element 

DomNode 


Circuit 

Element 

DomNode 


Circuit 

Element 

DomNode 


Contexts 

Typically one of each per document 

■ SelectionContext 

■ Tracks user's selection and has change events 

■ HistoryContext 

■ Tracks DOM changes to sub-tree for undo/redo 

■ TransactionContext 

■ Base class of HistoryContext. Tracks when a set of changes 
begins and finishes, so that validation logic can be executed 
at correct time. 

■ InstancingContext 

■ Implements copy, paste, and delete 


Registries 

One of each of per app 

■ DocumentRegistry- tracks documents 

■ List of open documents 

■ Adds and removes documents 

■ Active document 

■ ContextRegistry - tracks contexts 

■ List of available "contexts" 

■ Adds and removes contexts 

■ Active context 

■ IControl Registry, IControlHostService 

■ Clients register Controls, so that they appear in docking 
framework. Active Control is tracked. 


Services 

One of each per app. Provides functionality to other components. 

■ ControlHostService 

■ Docking framework 

■ CommandService 

■ Menus and toolbars 

■ SettingsService 

■ User and app settings GUI and persistence 

■ PerforceService 

■ SkinningService 

■ Etc. 


Editors 

One of each per app; work with active context 


■ PropertyEditor 

■ 2-column property editor with names and values 

■ GridPropertyEditor 

■ Spreadsheet-style multi-object property editor 

■ TimelineEditor 

■ CircuitEditor 

■ CurveEditor 


■ Etc. 


ATF Pros and Cons 


■ Pros 

■ Easy to create editing tools with all of the standard 
features -- copy & paste, undo & redo, windows docking, 
user settings, document persistence (if using XML files), 
etc. 

■ Powerful components for specific tasks 

■ Circuit editing 

■ Timeline editing 

■ Property editing 

■ Direct2D wrappers 


ATF Pros and Cons 


Cons 

■ Connections between components are usually abstract 
and use C# interfaces and Adaptability. It can be difficult 
to know which components are working with each other. 
Tip: use debugger. 

■ Steep learning curve. We've tried to address this with 
well-written and thorough docs. 

■ The DOM is difficult to debug. Use DomNodeAdapters, 
DOM Recorder, and DOM Explorer. 


Tip 

"Features are an asset. Code is a liability. 
Bill Budge 



Creating shared code is 2x to 3x slower. 

■ Avoiding breaking changes 

■ Difficult to know how clients are using your code 



Tip 


Clients want to customize everything! 

■ Expect to need to make class members public or 
protected. 

■ If you're unsure, keep it private and then make it 
public upon request. 


Tip 


Code Reviews? 

■ Always: for new C# interfaces 

■ Always: for significant new features 

■ "It Depends": for more minor changes 


Tip 


Have written coding standards 

■ For C#, see "Framework Design Guidelines 
MSDN 


Build "orthogonally". 

■ Try to have minimal well-defined dependencies 
other classes. 

■ Program against interfaces instead of concrete 
classes where possible. 


Tip 

Leave yourself a backdoor with the 'info' object 


public interface IDocumentClient 

{ 

DocumentClientlnfo Info 

{ 

get; 


} 


Tip 


Prefer IEnumerable<T> over IList<T> in APIs 
Never use List<T> 


Tip 


When developing a large new piece of tech, 
try to find a client to work with. 

■ This validates your approach. 

■ When finished, you'll have at least one client. 


Write the release note for a breaking change, 
before making the breaking change. 

■ What is this breaking change? 

■ Why is this breaking change necessary? 

■ How do clients fix their code? 


Tip 


Make C# interfaces be as small as possible. 

■ If it has > 6 completely different kinds of 
members, that's a code smell 

■ Use extension methods to provide utility 
methods. 


Tip 

■ Visit clients once or twice a year for a "road 
show" 

■ Show off your latest work. 

■ See what they're up to. 

■ Get ideas for future projects. 

■ Spread knowledge between clients. 


Resources 


Full Featured Examples 

• Circuit Editor 

• Statechart Editor 

• Timeline Editor 

• Using Direct2D 

• Model Viewer 
• • • 

Massive wiki documentation 
Issue tracker 
Responsive staff © 


github.com/SonyWWS 




Sony Computer Entertainment, 
Worldwide Studios * 

Open source software for game development on Playstation platforms 

03 http : //www. wo rldwide stu . . . 


Questions? Thank you! 




